home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 289 / turtle3 / terrapin.doc < prev    next >
Encoding:
Text File  |  1989-03-19  |  6.7 KB  |  144 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                              TERRAPIN
  13.                   Version 1.30     January, 1989
  14.  
  15.                   A large file copy utility by:
  16.                      
  17.                         George R. Woodside
  18.                      5219 San Feliciano Drive
  19.                   Woodland Hills, Ca. 91364 USA
  20.  
  21.  
  22.      TERRAPIN  is a file copy utility designed to provide  support 
  23. for  saving and restoring files which exceed the size of a  floppy 
  24. disk. 
  25.  
  26.      It  accomplishes this task by splitting the large  file  into 
  27. segments and writing the segments onto multiple floppy disks.  The 
  28. segments are not altered or compressed in any manner.  They may be 
  29. accessed as normal data on the floppy, although they would only be 
  30. a  portion  of  the original file.  Each segment is  as  large  as 
  31. the floppy disk will allow.  A secondary file is posted with  each 
  32. segment  to provide information used in restoring  the  file.  The 
  33. secondary  file always bears the name "PART.###" where "###" is  a 
  34. sequence number, beginning with 001. 
  35.  
  36.      TERRAPIN executes from the GEM Desktop, with a standard menu. 
  37. Under the Desk menu title is the standard "ABOUT" item, which will 
  38. provide a dialog box noting the version of the program.
  39.  
  40.      There  are  four items under the File  title:  Save  a  File, 
  41. Restore a File, File Selector, and Quit.
  42.  
  43.      "Save  a  File" is the entry used to begin the copying  of  a 
  44. file  to  floppy  disks.  It will offer a  file  selector  box  to 
  45. identify  the file to be saved.  Once that selection  is  made,  a 
  46. dialog box will be presented for selection of a floppy disk drive. 
  47. Select either drive A or drive B to start copying a file,  or Quit 
  48. to return to the main menu.  This process is repeated until either 
  49. the file has been fully copied, or Quit is selected.
  50.  
  51.      "Restore a File" is the companion procedure.  It will offer a 
  52. file selector, initially from floppy disk A. Select the file to be 
  53. restored  (you  should  be  selecting  it  from  the  floppy  disk 
  54. containing  part  one of the file).  Select the  file  name  which 
  55. corresponds  to the name under which it was saved,  do not  select 
  56. the  file  named  "PART.001".  A  second  file  selector  will  be 
  57. presented to select the drive, and file name, for the output file. 
  58. The  default  for the output is the same file name as  the  input. 
  59. Once  the name has been selected,  file restoring will  begin.  As 
  60. each  disk is read,  and the file restored,  a dialog box will  be 
  61. displayed to indicate which drive to read for the next segment  of 
  62. the  file  being  restored.  When the  file  has  been  completely 
  63. restored,  the file's date and time stamp will be set to the  same 
  64. value as the original copy of the file.
  65.  
  66.      "File Selector" is an option available to defeat the built in 
  67. file  selector.  Since the standard GEM File Selector is  somewhat 
  68. limited,  TERRAPIN  contains a more sophisticated one.  It  offers 
  69. buttons to select drives,  posts a title line to indicate  exactly 
  70. what file is being selected,  remembers exactly where it was  when 
  71. it is called next time, and positions itself at that point. If you 
  72. have a replacement file selector built into your system,  you  may 
  73. prefer to use that one.  Doing so, however, will cause the loss of 
  74. the features in TERRAPIN's file selector,  particularly the  title 
  75. line.
  76.  
  77.                               ERRORS 
  78.  
  79.      Most anything can go wrong,  and probably will,  says Murphy. 
  80. He  is quite right.  TERRAPIN is prepared for  most  errors.  When 
  81. writing disks,  it may find that the disk inserted for writing  is 
  82. not empty, not formatted, or already contains a partial file which 
  83. will  conflict with the one being copied.  Available  options  for 
  84. recovery  include  changing  to  a  different  disk,  erasing  the 
  85. offending disk, reformatting it, changing to the other disk drive, 
  86. using  whatever space is available on the disk,  or  quitting  the 
  87. file copy altogether.  These situations occur when a disk is first 
  88. being accessed. 
  89.  
  90.      You may change disks in the selected drive,  and select  this 
  91. option, if you want to continue the file copy on a different disk.
  92.  
  93.      You may have the disk erased (it takes about two seconds) and 
  94. have the file written to it.  Erasing a disk is total: every file, 
  95. every folder,  and the disk label are all erased,  and the  output 
  96. file will be the only thing on the disk. 
  97.  
  98.      You may have the output disk formatted, it it is unformatted, 
  99. or  you wish to change the format of the  disk.  Options  offerred 
  100. include 9 or 10 sectors per track, and 80, 81, or 82 tracks. While 
  101. both  9 and 10 sector formats are reliable,  9 sectors is  the  ST 
  102. standard.  Use of 81 or 82 tracks is not recommended, but may work 
  103. on some disk drives.  It is important to note that disks formatted 
  104. with  anything other than 9 sectors,  and 80 tracks,  can  not  be 
  105. copied in disk-to-disk mode from the ST Desktop.
  106.  
  107.      The next option is to use the disk anyway,  exactly as it is. 
  108. This  may be desirable if the portion of the file remaining to  be 
  109. copied is small enough to fit on a partially filled disk. TERRAPIN 
  110. will copy the portion of the file which will fit on the disk,  and 
  111. continue if there is more to be done.  The only exception to  this 
  112. situation is if the segment number of the file being copied is the 
  113. same  as the number of the segment of some other file on the  same 
  114. disk.  This  would  result  in  the  destruction  of  the  segment 
  115. information of the previous file, and will not be done.
  116.  
  117.      The last option presented is to change disk drives.  Click on 
  118. the button bearing the name of the other disk drive.
  119.  
  120.      The  more  complex error situation is when  a  write  failure 
  121. occurrs  during the copying process.  TERRAPIN recovers from  this 
  122. situation  by  acting as if the disk with the  write  error  never 
  123. existed.  Change to a different disk, and TERRAPIN will resume the 
  124. file  copy,  starting at the same place it was when the  defective 
  125. disk was first inserted. Discard the disk with the error.
  126.  
  127.      Errors  reading  the  file from the floppy  disk  during  the 
  128. restore function  are not recoverable.  
  129.  
  130.      TERRAPIN is copyrighted,  but released for public distribution. 
  131. TERRAPIN  is  not to be sold except for nominal charges  for  media, 
  132. reproduction, and/or connect charges while downloading. 
  133.   
  134.      If TERRAPIN gives you any trouble, or you have any suggestions, 
  135. please feel free to contact: 
  136.  
  137.      George R.  Woodside            Compuserve  76537,1342 
  138.      5219 San Feliciano Dr.         GEnie       G.WOODSIDE
  139.      Woodland Hills, Ca. 91364 
  140.  
  141.      USENET: ..!{philabs|csun|psivax}!ttidca!woodside
  142.      or      woodside@ttidca
  143.  
  144.